home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1994 #2 / Monster Media No. 2 (Monster Media)(1994).ISO / pcboard / makebn15.zip / MAKEBLTN.DOC < prev    next >
Text File  |  1994-06-09  |  12KB  |  234 lines
  1.  *************************************************************************
  2.  *                           MAKEBLTN.EXE                                *
  3.  *                     A PCBoard 15 Sysop Utility                        *
  4.  *                   version: 1.5   date: 05/27/1994                     *
  5.  *              (c) Copyright 1994  by Al & Mike Segura                  *
  6.  *************************************************************************
  7.  
  8.  
  9. Purpose:        To analyze the PCBoard USERS file information and generate
  10.                 several bulletins: Top Callers, Top Downloaders, Top Up-
  11.                 loaders, and Top Cities.  Works on 1 to multi-node network
  12.                 systems and on very large systems (upto 90,000 users).
  13.  
  14.  
  15. Contents:       1.   MAKEBLTN.DOC    this file.
  16.                 2.   MAKEBLTN.EXE    the subject EXE file.
  17.                 3.   FILE_ID.DIZ     brief BBS text description of this item.
  18.                 4.   MAKEBLTN.CFG    sample configuration file.
  19.  
  20.  
  21.  
  22. Description:    MAKEBLTN.EXE will generate one combined or four separate
  23.                 bulletins on top caller information.  PCBoard color codes
  24.                 are also inbedded in the bulletins and are Sysop configurable.
  25.  
  26.                 The program is configured by the Sysop through the use of
  27.                 file MAKEBLTN.CFG and is defined below:
  28.  
  29.  
  30.                                      sample CFG file entries
  31.                                    -------------------------------------
  32.                         Line 1:         C:\PCB\MAIN\USERS
  33.                         Line 2:         AL SEGURA
  34.                         Line 3:         USER2
  35.                         Line 4:         USER3
  36.                         Line 5:         USER4
  37.                         Line 6:         USER5
  38.                         Line 7:         15
  39.                         Line 8:         10
  40.                         Line 9:         SEPARATE
  41.                         Line 10:        BLUE
  42.                         Line 11:        CYAN BWHITE
  43.                         Line 12:        BLUE BYELLOW
  44.                         Line 13:        BLUE BMAGENTA
  45.  
  46.  
  47.                         Line 1: Path to PCBoard USERS file
  48.                         Line 2 - 6: Names of up to 5 users to exclude from
  49.                                     bulletins, case insensitive.
  50.                         Line 7: Number of top cities
  51.                         Line 8: Number of top callers/down-uploaders
  52.                         Line 9: TOGETHER or SEPARATE (make 1 or 4 bulletins)
  53.                         Line 10: Main Background Color (PCB colors)
  54.                         Line 11: Border Background/Text colors (BWHITE = Bright
  55.                                   White)
  56.                         Line 12: Info Background/Text colors
  57.                         Line 13: Header Background/Text colors
  58.  
  59.  
  60.  
  61. Execution:      The program is executed by entering the program name
  62.                 (MAKEBLTN.EXE).  The program will then read its CFG file, if
  63.                 not found, it will generate a default CFG file of its own.
  64.                 Next, the program reads the PCBoard USERS file.  NOTE: the
  65.                 USERS file is only 'read', NO modifications are made!!
  66.  
  67.                 Once executed, the program displays an opening credit, follow-
  68.                 ed by status messages, such as: reading user records, computing
  69.                 top callers, writing reports, etc.  If the Sysop selected
  70.                 combined bulletins, then one file named TOP1 is generated, if
  71.                 separate bulletins was selected, then files TOP1, TOP2, TOP3,
  72.                 and TOP4 are generated--all in the same directory as the EXE
  73.                 file. (If separate, TOP1 = top cities, TOP2 = top uploaders,
  74.                 TOP3 = top downloaders, TOP4 = top callers).  The TOPx files
  75.                 can then be called as text display or intro files, or the
  76.                 BLT.LST file can be edited to display them as main board or
  77.                 conference bulletins.
  78.  
  79.                 The program may be run stand-alone or from an EVENT or Batch
  80.                 file.  If older versions of the bulletins are present, the
  81.                 program will over-write them.
  82.  
  83.  
  84.  
  85. Registration:   Registration fee is $10 US, and applies to all future versions
  86.                 of the program as well--in other words, only register once.
  87.                 Payable in cash, check or money-order and mailable to:
  88.                 A. Segura, P.O. Box 1089, Sterling, VA, 20167-1089.
  89.  
  90.                 When you register, you will receive the key to eliminate the
  91.                 UNREGISTERED message in the bulletins.
  92.  
  93.                 Also, if you would like to provide suggestions for
  94.                 improvement to the program, bug reports, or just a note
  95.                 of thanks or hello, please forward those as well.  See
  96.                 below for my mailing address and BBS number.  Additionally,
  97.                 I frequently browse the RIME Sysop and PCBoard conferences,
  98.                 although contacting me there is not as reliable because
  99.                 sometimes I get very busy.
  100.  
  101.  
  102.  
  103. Updates:        The latest version of the EXE program can be obtained from
  104.                 my BBS: SBG Online! BBS (703) 450-9456.  If you have any
  105.                 comments or suggestions for improvement, you can leave them
  106.                 there also.  The file will be found in directory #1 as a
  107.                 FREE/NOTIME file.  The BBS runs PCBoard 15 at 14400v42bis.
  108.  
  109.                 I also post the latest versions on SALT AIR and WORLDNET BBSs.
  110.                 WorldNet was featured in the May edition of BoardWatch
  111.                 magazine, tell Tony that Al sent 'ya.  You can also usually
  112.                 reach me in the RIME conferences  (Sysops, PCBoard/Hints/
  113.                 Utils, etc)  (SBGONLINE, #5561  RIME).
  114.  
  115.  
  116.  
  117. Source          If you desire a diskette containing the C source code so
  118. Code:           you can modify it for your own use, the cost is $25 US.  I
  119.                 accept cash, check, money order, or VISA/MC.  You can place
  120.                 an order online on the BBS (703) 450-9456 or by mail at:
  121.                 A. Segura, P.O. Box 1089, Sterling, VA, 20167-1089.
  122.  
  123.  
  124.                 Additionally, for $25, you can subscribe to the PPE
  125.                 conference on my BBS.  The conference will always contain
  126.                 the latest version of the source code for CALLBLOC,
  127.                 CALLERID, VULGARID and several other PPEs for immediate
  128.                 downloading.  The subscription period lasts one year.  We
  129.                 also have the latest version of the PIER Shareware CDROM
  130.                 always online.  You can even subscribe online with your
  131.                 VISA/MC via (S)cript Questionaire #2 for immediate access.
  132.  
  133.  
  134.  
  135. Distribution:   You may freely distribute this complete package, only in an
  136.                 unmodified form.  No remuneration may be collected or charged
  137.                 for this work by anyone other than the below noticed
  138.                 individual/company except for that cost incurred in actual
  139.                 electronic media production (i.e. diskette or CDROM).  In
  140.                 other words, it can be placed on BBSs, shareware CDROMS, etc.
  141.                 but I/my company reserves the right of copyright and
  142.                 remuneration for the actual work.  The source code may NOT
  143.                 be distributed by anyone other than the below listed company.
  144.  
  145.  
  146. Disclaimer:     The user agrees when utilizing this package that he does so
  147.                 at his own risk with no guarantees, implied or otherwise, as
  148.                 to the functional performance or liability of the package.
  149.  
  150.  
  151.  
  152. Development History:
  153.  
  154. Vers.    Date       Remarks
  155. -----   --------    -------------------------------------------------------
  156.  1.0    05/01/94    Initial release.
  157.  1.1    05/07/94    Fixed bug which prevented file sharing for multi-node
  158.                      systems.
  159.  1.2    05/08/94    Well, 1.1 didn't do it, so, 1.2.
  160.  1.3    05/13/94    Modified to work with LARGE users files/systems.
  161.  1.4    05/19/94    Fixed 2 bugs, # of cities => # of callers, calls > 255
  162.  1.5    06/09/94    Fixed Top Callers # of calls math bug.
  163.  
  164.  
  165. ***************************************************************************
  166. *        (c) Copyright 1994  A&M Segura/Fax~An~Ad Marketing, Inc.         *
  167. ***************************************************************************
  168.  
  169.  
  170. Other PPEs:
  171.  
  172.  ********************************************************************
  173.  *      Look for these other fine utilities at a BBS near you       *
  174.  ********************************************************************
  175.  
  176.  AUTOSUBS.PPE   run as a script questionnaire, allows online credit
  177.                 card subscriptions to BBS (VISA/MC), completes log
  178.                 entries and sends alert message to SysOp. (for
  179.                 PCBoard 15)
  180.  
  181.  ALLCALL.PPE    generates a text display bulletin, complete with PCB
  182.                 color codes, of all the callers to the board.
  183.  
  184.  ALLSTAT.PPE    generates a text display bulletin, complete with PCB
  185.                 color codes, of statistics of all the callers to the board.
  186.  
  187.  BULLCHK.PPE    performs automated tracking of bulletins read by the
  188.                 user and performs a user upgrade when all sysop selected
  189.                 bulletins have been read.
  190.  
  191.  CALLERID.PPE   performs basic callerid identification, logs info
  192.                 in file log and user records if desired, and will
  193.                 also display desired text screens to users--must
  194.                 have callerid capable modem.  Several SysOp config-
  195.                 uable options. (for PCBoard 15)
  196.  
  197.  CALLBLOC.PPE   performs a call blocking function before the
  198.                 user can log on based upon a SysOp defined listing
  199.                 of undesirable phone numbers--must have callerid
  200.                 capable modem. Even sends the SysOp an alert message.
  201.                 (for PCBoard 15)
  202.  
  203.  DUP-BLOC.PPE   Blocks current users from signing-on with duplicate
  204.                 records--uses CallerID info.  Should be used with
  205.                 CALLBLOC.PPE for complete blocking system.
  206.  
  207.  MAKEBLTN.EXE   Top callers, cities, down/uploaders bulletin generator
  208.  
  209.  PADLOADS.EXE   Automated uploads directory padder--makes your BBS look
  210.                 more active with more daily uploads.
  211.  
  212.  REPORT.EXE     Program generates reports of CallerID info, user record
  213.                 phone numbers, common passwords and several other goodies
  214.                 to aid Sysop in identifying abusive or questionable users.
  215.  
  216.  VULGAR.PPE     performs a vulgar word/phrase check on user names and
  217.                 city entries based on a file of names defined by
  218.                 SysOp, and performed before complete newuser login.
  219.                 (for PCBoard 15)
  220.  
  221.  VULGARID.PPE   same program as VULGAR.PPE except it automatically
  222.                 passes the callerid info to CALLBLOC.PPE program
  223.                 for future lock-outs. (must have both programs and a
  224.                 modem that supports callerid) (for PCBoard 15)
  225.  
  226.                 NOTE: VULGARID ver. 1.x only works with CALLBLOC
  227.                       ver. 1.x.  VULGARID ver. 2.x only works
  228.                       with CALLBLOC ver. 2.x.
  229.  
  230. ***************************************************************************
  231. *        (c) Copyright 1993  A. Segura/Fax~An~Ad Marketing, Inc.          *
  232. ***************************************************************************
  233.  
  234.